.TH E1432_SET_DATA_FORMAT 3 E1432
.SH NAME
e1432_set_data_format \- Set all data format parameters, except data port
.IX e1432_set_data_format(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_data_format(E1432ID hw, SHORTSIZ16 ID,
                                 LONGSIZ32 blocksize, SHORTSIZ16 size,
                                 SHORTSIZ16 mode, SHORTSIZ16 append)
.cE
.SH DESCRIPTION
\fIe1432_set_data_format\fR sets all of the parameters associated with
the data format section of an E1432 or group of E1432s.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIblocksize\fR selects the number of sample points in a block.
A number between 1 and an upper limit that depends on the amount of 
memory installed is a valid value for \fIblocksize\fR.
This parameter should not take into account the size of the appended
status data.
This parameter may also be set with \fIe1432_set_blocksize\fR.

\fIsize\fR selects the number of bits of precision for the fixed point, two's 
complement data outputs from the E1432.
The legal values for this parameter are \fBE1432_DATA_SIZE_16\fR,
\fBE1432_DATA_SIZE_32\fR, and \fBE1432_DATA_SIZE_32_SERV\fR.
This parameter may also be set with \fIe1432_set_data_size\fR.

\fImode\fR selects whether the E1432's data collection operates in block
mode or continuous mode.
\fBE1432_BLOCK_MODE\fR selects block transfer mode.  
\fBE1432_CONTINUOUS_MODE\fR means data collection will be continuous.
This parameter may also be set with \fIe1432_set_data_mode\fR.

\fIappend\fR selects whether or not status information is appended to a
data block.
Specifying \fBE1432_APPEND_STATUS_ON\fR means that an extra block of status
information is appended to the end of each data block transferred.
\fBE1432_APPEND_STATUS_OFF\fR disables this feature.
This parameter may also be set with \fIe1432_set_append_status\fR.
.SH "RESET VALUE"
After a reset, \fIblocksize\fR is set to \fB1024\fR (1K),
\fIsize\fR is set to \fBE1432_DATA_SIZE_16\fR,
\fImode\fR is set to \fBE1432_BLOCK_MODE\fR, and
\fIappend\fR is set to \fBE1432_APPEND_STATUS_OFF\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_append_status, e1432_set_blocksize,
e1432_set_data_mode, e1432_set_data_size
.ad
